Add some missing symbols to the docs
authorMatthias Clasen <mclasen@redhat.com>
Wed, 9 Feb 2011 04:14:46 +0000 (23:14 -0500)
committerMatthias Clasen <mclasen@redhat.com>
Wed, 9 Feb 2011 04:21:39 +0000 (23:21 -0500)
12 files changed:
docs/reference/gtk/gtk3-sections.txt
gtk/gtkappchooserbutton.c
gtk/gtkborder.h
gtk/gtkcellarea.c
gtk/gtkcomboboxtext.c
gtk/gtkicontheme.c
gtk/gtkmenu.c
gtk/gtkmenuitem.c
gtk/gtkmenuitem.h
gtk/gtkprintbackend.c
gtk/gtkprintjob.c
gtk/gtkstyle.c

index 2dab31965187e6d232e1b07f9c1287198027d72f..0b08465feb66973de13c27707b99153c49d741f7 100644 (file)
@@ -2058,6 +2058,8 @@ gtk_menu_item_deselect
 gtk_menu_item_activate
 gtk_menu_item_toggle_size_request
 gtk_menu_item_toggle_size_allocate
+gtk_menu_item_get_reserve_indicator
+gtk_menu_item_set_reserve_indicator
 <SUBSECTION Standard>
 GTK_MENU_ITEM
 GTK_IS_MENU_ITEM
@@ -4202,6 +4204,7 @@ gtk_tree_view_column_set_clickable
 gtk_tree_view_column_get_clickable
 gtk_tree_view_column_set_widget
 gtk_tree_view_column_get_widget
+gtk_tree_view_column_get_button
 gtk_tree_view_column_set_alignment
 gtk_tree_view_column_get_alignment
 gtk_tree_view_column_set_reorderable
@@ -4286,6 +4289,7 @@ gtk_tree_view_row_expanded
 gtk_tree_view_set_reorderable
 gtk_tree_view_get_reorderable
 gtk_tree_view_get_path_at_pos
+gtk_tree_view_is_blank_at_pos
 gtk_tree_view_get_cell_area
 gtk_tree_view_get_background_area
 gtk_tree_view_get_visible_rect
@@ -5749,6 +5753,7 @@ gtk_style_new
 gtk_style_copy
 gtk_style_attach
 gtk_style_detach
+gtk_style_get_context
 gtk_style_set_background
 gtk_style_apply_default_background
 gtk_style_lookup_color
index 3fe38b95df5d8ea0d0f8f8fab17bc0fb01ec27e7..34cc573b35b4c89a023c4fc6bc03c7672d671e62 100644 (file)
@@ -753,14 +753,15 @@ gtk_app_chooser_button_append_custom_item (GtkAppChooserButton *self,
 }
 
 /**
- * gtk_app_chooser_button_select_custom_item:
+ * gtk_app_chooser_button_set_active_custom_item:
  * @self: a #GtkAppChooserButton
  * @name: the name of the custom item
  *
  * Selects a custom item previously added with
  * gtk_app_chooser_button_append_custom_item().
- * Use gtk_app_chooser_refresh() to bring the selection to its initial
- * state.
+ *
+ * Use gtk_app_chooser_refresh() to bring the selection
+ * to its initial state.
  *
  * Since: 3.0
  */
index 51a5b7bfd64ee0f9edac02a95fd5d0836030c7cc..db0cb8f012fe8bc8ee6134b420e699478b6a3725 100644 (file)
@@ -41,13 +41,13 @@ typedef struct _GtkBorder GtkBorder;
 
 /**
  * GtkBorder:
- * @left: The width of the left border.
- * @right: The width of the right border.
- * @top: The width of the top border.
- * @bottom: The width of the bottom border.
+ * @left: The width of the left border
+ * @right: The width of the right border
+ * @top: The width of the top border
+ * @bottom: The width of the bottom border
  *
- * A struct that specifies a border around a rectangular area that can
- * be of different width on each side.
+ * A struct that specifies a border around a rectangular area
+ * that can be of different width on each side.
  */
 struct _GtkBorder
 {
index 3050ff578ba2e9d0d67d80523576f53eae1fd560..eecb35b84a81cf42b69f2359f4d9f40bc13bc54f 100644 (file)
@@ -3100,9 +3100,11 @@ gtk_cell_area_remove_focus_sibling (GtkCellArea     *area,
  * @renderer: the #GtkCellRenderer expected to have focus
  * @sibling: the #GtkCellRenderer to check against @renderer's sibling list
  *
- * Returns %TRUE if @sibling is one of @renderer's focus siblings
+ * Returns whether @sibling is one of @renderer's focus siblings
  * (see gtk_cell_area_add_focus_sibling()).
  *
+ * Return value: %TRUE if @sibling is a focus sibling of @renderer
+ *
  * Since: 3.0
  */
 gboolean
index be0a076a1dbd075235eb4d53e8cefaec92c74f89..ba6c0511797b0e05cfb1155b451f6680755fa79e 100644 (file)
@@ -408,10 +408,11 @@ gtk_combo_box_text_insert_text (GtkComboBoxText *combo_box,
 /**
  * gtk_combo_box_text_append:
  * @combo_box: A #GtkComboBoxText
+ * @id: (allow-none): a string ID for this value, or %NULL
  * @text: A string
  *
- * Appends @text to the list of strings stored in @combo_box.  If @id is
- * non-%NULL then it is used as the ID of the row.
+ * Appends @text to the list of strings stored in @combo_box.
+ * If @id is non-%NULL then it is used as the ID of the row.
  *
  * This is the same as calling gtk_combo_box_text_insert() with a
  * position of -1.
@@ -432,8 +433,8 @@ gtk_combo_box_text_append (GtkComboBoxText *combo_box,
  * @id: (allow-none): a string ID for this value, or %NULL
  * @text: a string
  *
- * Prepends @text to the list of strings stored in @combo_box.  If @id
- * is non-%NULL then it is used as the ID of the row.
+ * Prepends @text to the list of strings stored in @combo_box.
+ * If @id is non-%NULL then it is used as the ID of the row.
  *
  * This is the same as calling gtk_combo_box_text_insert() with a
  * position of 0.
index 1cd27cd8d110e5b06dd6d2065f51cb5e63e98332..88b89e201cf82a93f5e6b643af8f7725ec7bba68 100644 (file)
@@ -738,21 +738,19 @@ gtk_icon_theme_set_search_path (GtkIconTheme *icon_theme,
 /**
  * gtk_icon_theme_get_search_path:
  * @icon_theme: a #GtkIconTheme
-
  * @path: (allow-none) (array length=n_elements) (element-type filename) (out):
- *        location to store a list of icon theme path directories or %NULL .
- *        The stored value should be freed with g_strfreev().
- * @n_elements: location to store number of elements
- *              in @path, or %NULL
- * 
+ *     location to store a list of icon theme path directories or %NULL.
+ *     The stored value should be freed with g_strfreev().
+ * @n_elements: location to store number of elements in @path, or %NULL
+ *
  * Gets the current search path. See gtk_icon_theme_set_search_path().
  *
  * Since: 2.4
- **/
+ */
 void
-gtk_icon_theme_get_search_path (GtkIconTheme      *icon_theme,
-                               gchar            **path[],
-                               gint              *n_elements)
+gtk_icon_theme_get_search_path (GtkIconTheme  *icon_theme,
+                                gchar        **path[],
+                                gint          *n_elements)
 {
   GtkIconThemePrivate *priv;
   int i;
index d363009ac472b893bb2800f639e913a4341d8d6c..dee69b88efb84b85f871a2e5ccfc1795a2ca81a7 100644 (file)
@@ -1987,12 +1987,12 @@ gtk_menu_set_accel_group (GtkMenu       *menu,
 
 /**
  * gtk_menu_get_accel_group:
- * @menu a #GtkMenu
+ * @menu: a #GtkMenu
  *
  * Gets the #GtkAccelGroup which holds global accelerators for the
- * menu.  See gtk_menu_set_accel_group().
+ * menu. See gtk_menu_set_accel_group().
  *
- * Returns: (transfer none): the #GtkAccelGroup associated with the menu.
+ * Returns: (transfer none): the #GtkAccelGroup associated with the menu
  */
 GtkAccelGroup*
 gtk_menu_get_accel_group (GtkMenu *menu)
@@ -2418,8 +2418,11 @@ gtk_menu_get_title (GtkMenu *menu)
  * gtk_menu_reorder_child:
  * @menu: a #GtkMenu
  * @child: the #GtkMenuItem to move
- * @position: the new position to place @child.  Positions are
- *            numbered from 0 to n-1.
+ * @position: the new position to place @child.
+ *     Positions are numbered from 0 to n - 1
+ *
+ * Moves @child to a new @position in the list of @menu
+ * children.
  */
 void
 gtk_menu_reorder_child (GtkMenu   *menu,
index 855fe0e6857949d971ce50be280fe5e13bd4f187..6194ee567e77016814ded880385808aa2f20b2fd 100644 (file)
@@ -2564,9 +2564,23 @@ gtk_menu_item_get_use_underline (GtkMenuItem *menu_item)
   return FALSE;
 }
 
+/**
+ * gtk_menu_item_set_reserve_indicator:
+ * @menu_item: a #GtkMenuItem
+ * @reserve: the new value
+ *
+ * Sets whether the @menu_item should reserve space for
+ * the submenu indicator, regardless if it actually has
+ * a submenu or not.
+ *
+ * There should be little need for applications to call
+ * this functions.
+ *
+ * Since: 3.0
+ */
 void
-gtk_menu_item_set_reserve_indicator (GtkMenuItem         *menu_item,
-                                    gboolean             reserve)
+gtk_menu_item_set_reserve_indicator (GtkMenuItem *menu_item,
+                                     gboolean     reserve)
 {
   GtkMenuItemPrivate *priv;
 
@@ -2581,8 +2595,21 @@ gtk_menu_item_set_reserve_indicator (GtkMenuItem         *menu_item,
     }
 }
 
+/**
+ * gtk_menu_item_get_reserve_indicator:
+ * @menu_item: a #GtkMenuItem
+ *
+ * Returns whether the @menu_item reserves space for
+ * the submenu indicator, regardless if it has a submenu
+ * or not.
+ *
+ * Returns: %TRUE if @menu_item always reserves space for the
+ *     submenu indicator
+ *
+ * Since: 3.0
+ */
 gboolean
-gtk_menu_item_get_reserve_indicator (GtkMenuItem         *menu_item)
+gtk_menu_item_get_reserve_indicator (GtkMenuItem *menu_item)
 {
   g_return_val_if_fail (GTK_IS_MENU_ITEM (menu_item), FALSE);
 
index 4132e422869da0cddad123b9d54a7d489f2e4218..6c8dee4c37752c8e2d7d386fffef8a69213064ac 100644 (file)
@@ -119,9 +119,9 @@ void       gtk_menu_item_set_use_underline    (GtkMenuItem         *menu_item,
                                                gboolean             setting);
 gboolean   gtk_menu_item_get_use_underline    (GtkMenuItem         *menu_item);
 
-void       gtk_menu_item_set_reserve_indicator(GtkMenuItem         *menu_item,
-                                              gboolean             reserve);
-gboolean   gtk_menu_item_get_reserve_indicator(GtkMenuItem         *menu_item);
+void       gtk_menu_item_set_reserve_indicator (GtkMenuItem        *menu_item,
+                                                gboolean            reserve);
+gboolean   gtk_menu_item_get_reserve_indicator (GtkMenuItem        *menu_item);
 
 G_END_DECLS
 
index df735c668caa4600c9c6760a7c8bdd247106b90a..f8858c1705a4573aa25f943aaa65039b4e1e82c8 100644 (file)
@@ -297,7 +297,7 @@ _gtk_print_backend_create (const gchar *backend_name)
 }
 
 /**
- * gtk_printer_backend_load_modules:
+ * gtk_print_backend_load_modules:
  *
  * Return value: (element-type GtkPrintBackend) (transfer container):
  */
index 634e6b45ca071834d14141e1f24b29cf82ecaaca..58d339778d0c4e0da54ac066036765cc1028439e 100644 (file)
@@ -765,9 +765,8 @@ gtk_print_job_get_page_ranges (GtkPrintJob *job,
 /**
  * gtk_print_job_set_page_ranges:
  * @job: a #GtkPrintJob
-
  * @ranges: (array length=n_ranges): pointer to an array of
- *          #GtkPageRange structs
+ *    #GtkPageRange structs
  * @n_ranges: the length of the @ranges array
  *
  * Sets the page ranges for this job.
@@ -993,7 +992,7 @@ gtk_print_job_get_collate (GtkPrintJob *job)
 }
 
 /**
- * gtk_print_job_set_collated:
+ * gtk_print_job_set_collate:
  * @job: a #GtkPrintJob
  * @collate: whether the job is printed collated
  *
index 1d31d1ef0376894f0723106cacf0e868cf2a66e2..cf88d1d07a601dd8a48a9d9a0f10301ed86d4261 100644 (file)
@@ -858,6 +858,16 @@ gtk_style_new (void)
   return style;
 }
 
+/**
+ * gtk_style_has_context:
+ * @style: a #GtkStyle
+ *
+ * Returns whether @style has an associated #GtkStyleContext.
+ *
+ * Returns: %TRUE if @style has a #GtkStyleContext
+ *
+ * Since: 3.0
+ */
 gboolean
 gtk_style_has_context (GtkStyle *style)
 {